CLIP BOT - free automatic highlight clips (TikTok / Shorts / Reels) from YouTube streams
=========================================================================================

WHAT YOU NEED
  - Windows 10 or 11, internet, and about 15 GB of free disk space.
  - Any PC works. A stronger graphics card (NVIDIA, AMD or Intel) makes it faster.
  - No admin rights needed.


INSTALL (about 5 minutes + downloads)
-------------------------------------
1. Before you unzip: right-click the downloaded ZIP file -> Properties -> at the bottom tick "Unblock"
   -> OK. (If there is no "Unblock" box, that's fine, skip this step.)
   This tells Windows you trust the file and prevents most of the warnings below.

2. Right-click the ZIP -> "Extract All..." -> choose a folder (for example Documents) -> Extract.
   Don't run anything from inside the ZIP.

3. Open the extracted "ClipBot" folder and double-click "Install Clip Bot".
   A black window shows the progress. When it's done, Clip Bot opens by itself, and you'll find a
   "Clip Bot" icon on your Desktop and in the Start Menu.

4. The first time Clip Bot opens:
   - Read the short notice and click "I understand".
   - Click "Download now". Clip Bot downloads its tools and AI models (about 4-10 GB, depending on
     your PC). This only happens once.


WINDOWS MESSAGES YOU MIGHT SEE (all normal for free apps without a paid certificate)
-----------------------------------------------------------------------------------
* While downloading the ZIP, Edge may say:
    "ClipBot.zip isn't commonly downloaded. Make sure you trust ClipBot.zip before you open it."
  -> Click "..." -> "Keep" -> "Keep anyway".

* When you start "Install Clip Bot", a blue box may say:
    "Windows protected your PC. Microsoft Defender SmartScreen prevented an unrecognized app from starting."
  -> Click "More info" -> "Run anyway".

* Or a box may say:
    "Open File - Security Warning. The publisher could not be verified. Are you sure you want to run this software?"
  -> Click "Run".

* If Windows says "Smart App Control blocked a file", do step 1 (Unblock), extract the ZIP again, and
  try again. Please DON'T turn off Smart App Control or your antivirus. Clip Bot doesn't need that.

* During the first setup, the "Ollama" AI engine installs itself (a small llama icon may appear near
  the clock). That's Clip Bot's local AI. It runs only on your PC.


HOW TO USE
----------
1. Open Clip Bot from the Desktop icon.
2. Paste a YouTube link: a live stream or a finished video. You can also click "File..." to use a video
   on your PC.
3. Click Start. Clip Bot watches and saves vertical clips by itself.
4. Your clips are in "Videos\Clip Bot". Each clip comes with a .txt file with a title, hashtags
   and the streamer credit, ready to paste.

Sensitivity slider: higher means more clips. The number next to it shows about how many clips per hour
to expect. The default is strict: only big moments get clipped.


IF SOMETHING GOES WRONG
-----------------------
- Clip Bot repairs missing files by itself: just start it again.
- Still stuck? Double-click "Install Clip Bot" again. It repairs the installation and keeps your
  clips and downloads.
- Click "Diagnostics" (bottom of the window) and send the report file to the Clip Bot author.
  The report contains no personal data, links or clips.

Age-restricted videos: YouTube wants a login for these. Close your browser, then open the file
app\settings.json in Notepad and set "youtube_cookies_browser": "firefox" (or "edge" / "chrome").
Clip Bot then uses your browser's YouTube login. This is optional.


UPDATES
-------
When there is a new version, Clip Bot shows "Update available" at the bottom of the window. Download
the new ZIP, extract it OVER the old ClipBot folder (choose "Replace"), and run "Install Clip Bot"
again. Your clips, settings and AI models are kept. The YouTube downloader updates itself.


UNINSTALL
---------
Run app\Uninstall Clip Bot.bat, then delete the ClipBot folder. Your clips in Videos\Clip Bot are
kept. (Optional: remove "Ollama" in Windows Settings -> Apps.)


IMPORTANT
---------
You are responsible for the content you download, clip and upload. Respect copyright and the rules
of YouTube, TikTok and Instagram, and credit the streamer (Clip Bot adds the credit for you).
Clip Bot is free and open source (MIT). See app\THIRD_PARTY_LICENSES.txt for all components.
